home *** CD-ROM | disk | FTP | other *** search
/ 3D Images / 3D Images.iso / programs / amiga / rayshade / man / rlecomp.man < prev    next >
Text File  |  1995-01-12  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. RLECOMP(1)                                             RLECOMP(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        rlecomp - Digital image compositor
  9.  
  10. SSYYNNOOPPSSIISS
  11.        rrlleeccoommpp [ --oo _o_u_t_f_i_l_e ] _A_f_i_l_e _o_p_e_r_a_t_o_r _B_f_i_l_e
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.        _r_l_e_c_o_m_p  implements  an image compositor based on presence
  15.        of an alpha, or matte channel the image.  This extra chan­
  16.        nel  usually  defines  a mask which represents a sort of a
  17.        cookie-cutter for the image.  This is the case when  alpha
  18.        is  255  (full coverage) for pixels inside the shape, zero
  19.        outside, and between zero and 255  on  the  boundary.   If
  20.        _A_f_i_l_e or _B_f_i_l_e is just a single -, then _r_l_e_c_o_m_p reads that
  21.        file from the standard input.
  22.  
  23.        The operations behave as follows (assuming  the  operation
  24.        is "_A _o_p_e_r_a_t_o_r _B"):
  25.  
  26.        oovveerr   The  result  will  be  the  union  of the two image
  27.               shapes, with _A obscuring _B in the region  of  over­
  28.               lap.
  29.  
  30.        iinn     The  result  is simply the image _A cut by the shape
  31.               of _B.  None of the image data of _B will be  in  the
  32.               result.
  33.  
  34.        aattoopp   The  result  is  the  same shape as image _B, with _A
  35.               obscuring _B where the image shapes  overlap.   Note
  36.               this  differs  from  oovveerr  because the portion of _A
  37.               outside _B's shape does not appear in the result.
  38.  
  39.        oouutt    The result image is image _A with the shape of _B cut
  40.               out.
  41.  
  42.        xxoorr    The  result is the image data from both images that
  43.               is outside the overlap region.  The overlap  region
  44.               will be blank.
  45.  
  46.        pplluuss   The result is just the sum of the image data.  Out­
  47.               put values are clipped to 255 (no overflow).   This
  48.               operation  is  actually  independent  of  the alpha
  49.               channels.
  50.  
  51.        mmiinnuuss  The result of _A -  _B,  with  underflow  clipped  to
  52.               zero.   The  alpha  channel is ignored (set to 255,
  53.               full coverage).
  54.  
  55.        ddiiffff   The result of abs(_A - _B).  This is useful for  com­
  56.               paring two very similar images.
  57.  
  58.        aadddd    The  result of _A + _B, with overflow wrapping around
  59.               (_m_o_d 256).
  60.  
  61.  
  62.  
  63.  
  64. 1                       December 20, 1986                       1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RLECOMP(1)                                             RLECOMP(1)
  71.  
  72.  
  73.        ssuubbttrraacctt
  74.               The result of _A - _B, with underflow wrapping around
  75.               (_m_o_d  256).   The aadddd and ssuubbttrraacctt operators can be
  76.               used to perform reversible transformations.
  77.  
  78.  
  79. SSEEEE AALLSSOO
  80.        _u_r_t(1), _R_L_E(5),
  81.        "Compositing Digital Images", Porter and Duff, _P_r_o_c_e_e_d_i_n_g_s
  82.        _o_f _S_I_G_G_R_A_P_H _'_8_4 p.255
  83.  
  84. AAUUTTHHOORRSS
  85.        Rod Bogart and John W. Peterson
  86.  
  87. BBUUGGSS
  88.        The  other  operations  could be optimized as much as oovveerr
  89.        is.
  90.  
  91.        _R_l_e_c_o_m_p assumes both input files have the same  number  of
  92.        channels.
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. 1                       December 20, 1986                       2
  131.  
  132.  
  133.